home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 March
/
EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso
/
earcd
/
comm2
/
xstat115.lha
/
XStat.dok
< prev
next >
Wrap
Text File
|
1994-06-20
|
20KB
|
601 lines
Dokumentation zu XStat V1.15
============================
Programm und Dokumentation sind © Copyright 1992-94 by Jürgen Weinelt.
IMPORT StdDisclaimer; (* kurz: Benutzung auf eigene Gefahr *)
XStat wurde sorgfältig getestet, aber es können natürlich trotzdem noch
diverse Fehler 'drinnen sein.
XStat V1.15 ist Freeware. Es darf auf nicht-kommerziellem Weg weitergegeben
werden, solange die folgenden Bedingungen erfüllt sind:
* Quelltext, ausführbares Programm und Dokumentation müssen zusammen
weitergegeben werden (XStat.mod, XStat, XStat.data, XStat.doc,
XStat.dok und Make).
Die Dateien müssen unverändert weitergegeben werden!
Sie dürfen das Archiv nicht ändern (insbesondere auch keine Dateien
hinzufügen).
* Dieses Programm darf auf PD/FreeWare-CDs vertrieben werden unter
der Voraussetzung, daß ich bei Bestellung der betrefffenden CD einen
einmaligen Preisnachlaß von mindestens 50% des Verkaufspreises
eingeräumt bekomme. Ein Gratis-Exemplar wäre natürlich auch
eine nette Geste...
AUSNAHME: Fred Fish hat BEDINGUNGSLOS die Erlaubnis, diese
Programmversion in seine Softwarebibliothek aufzunehmen, egal ob auf
Floppy Disk oder auf CD.
XStat läuft nur mit AmigaOS V37 oder höher (das ist 2.04 oder höher).
Zusammenfassung
===============
XStat wertet das Xferstat-File aus, das bestimmte Varianten von
UUCiCo erzeugen (getestet mit der SWB-Variante und wUUCP). Die
wichtigste Information, die XStat liefert, sind die Telefonkosten
für einen bestimmten Zeitraum.
Installation
============
Kopieren Sie das Programm "XStat" an eine Stelle, die im
Suchpfad enthalten ist, vorzugsweise nach UUBIN:
Außerdem muß nur noch eine weitere Datei installiert werden;
sie heißt "XStat.data", und sollte am besten nach UULIB:
kopiert werden.
XStat.data muß Ihren Gegebenheiten entsprechend angepaßt werden,
um die Installation zu vervollständigen; editieren [Hi, PeterK ;-) ]
Sie es entsprechend.
Informationen über die mit V1.14 neu hinzugekommenen Ausgabe-Formate
und die zugehörigen Umgebungsvariablen finden Sie in der Datei
"FORMS.DOK".
XStat.data
==========
XStat.data enthält die Informationen über die Verbindungskosten zu jedem
Host, mit dem Sie eine Verbindung unterhalten, im folgenden Format:
XStat.data Datei-Header:
------------------------
H XSTAT DATA
Dieser Header muß am Anfang der ersten Zeile von XStat.data stehen.
XStat.data Kommentarzeile:
--------------------------
# beliebige Kommentare
Kommentarzeilen dürfen überall in der XStat.data Datei eingefügt
werden, außer natürlich vor dem Datei-Header!
XStat.data Währungs-Kennzeichen:
--------------------------------
S <Währungskennzeichen>
Gibt das Währungskennzeichen für Ihr Land an. Dieser Eintrag muß vor der
ersten "N"-Zeile stehen. Es darf höchstens eine "S"-Zeile in der
XStat.data Datei geben.
Beispiele:
# Währungskennzeichen für die U.S.A.
S $
# Währungskennzeichen für Deutschland:
S DM
XStat.data Host-Namen-Info:
---------------------------
N <Hostname> <Hostname> ...
Die "N"-Zeile kennzeichnet den Beginn eines neuen Verbindungs-Datensatzes.
Mindestens eine "C"-Zeile muß folgen! <Hostname> sollte der Name
einer UUCP-Site sein, mit der Sie direkt verbunden sind, ohne
irgendwelche Pfad- oder Domain-Informationen.
Beispiele:
# Mein eigener Newsfeed:
N imart
# Ein anderer Newsfeed:
N cbmger
Seit XStat V1.10 dürfen auch mehrere Namen in einer N-Zeile angegeben werden.
Alle diese Hosts erhalten dieselbe Kosteninformation zugeordnet.
Beispiel:
# Mehrere Hosts in derselben Entfernungszone
N cbmger brewak forge
Seit XStat V1.11 dürfen mehrere N-Zeilen aufeinander folgen.
Beispiel:
# Mehrere Hosts in derselben Entfernungszone
N cbmger
N brewak forge
N-Zeilen dürfen nicht länger als 100 Zeichen sein.
Seit XStat V1.11 darf der reservierte Host-Name ".default." verwendet werden.
Alle Connects, die nicht explizit einem Eintrag im XStat.data-File zugeordnet
werden können, werden auf diesem "Universal-Account" abgerechnet.
Seit XStat V1.12 darf der reservierte Host-Name ".illegal." verwendet werden.
Alle Connects, bei denen im XferStat-File der Host-Name fehlt (leer ist),
werden von XStat auf diesen Sammel-Account berechnet; die UUCiCos erzeugen
solche Zeilen manchmal, wenn die Verbindung vorzeitig abgebrochen wurde.
XStat.data Verbindungsdauer-Offset-Info:
----------------------------------------
O <offset>
Gibt an, daß die Zeitangabe im XferStat-File für diese Verbindung
normalerweise um <offset> Sekunden danebenliegt. Mit dieser Option
kann man die Verbindungsaufbau-Phase zwischen den Modems kompensieren,
die nicht in der im XferStat angegebenen Verbindungsdauer enthalten
ist. Diese Option wurde nur mit positiven Zeitangaben getestet.
Die "O"-Zeile muß direkt nach der "N"-Zeile stehen; nur eine "O"-
Zeile pro Host ist erlaubt.
Beispiel:
N imart
O 13
C ...
Gibt an, daß mein Modem normalerweise 13 Sekunden für den Verbindungs-
aufbau mit imart benötigt.
XStat.data Verbindungskosten-Info:
----------------------------------
C <Anfangszeit> <Dauer einer Einheit> <Preis einer Einheit>
Teilt XStat mit, daß zwischen <Anfangszeit> und <Anfangszeit der
nächsten C-Zeile> eine Verbindung mit dem zugehörigen Host
<Preis einer Einheit> pro <Dauer einer Einheit> kostet.
Die <Dauer einer Einheit> muß in Sekunden angegeben werden, der
<Preis einer Einheit> in der Währung, die Sie benutzen.
Die erste "C"-Zeile muß als Anfangszeit "SU-00:00:00" haben!
(Ausnahme siehe weiter unten bei LOCAL/IGNORE).
Beispiel:
N imart
C SU-00:00:00 120 0.23
C MO-08:00:00 60 0.23
C MO-18:00:00 120 0.23
Von Sonntag, 0:00:00 bis Montag, 7:59:59 kostet eine Verbindung
zwischen meinem Computer und dem von "imart" 23Pfg/120sec.
Von Montag, 8:00:00 bis Montag, 17:59:59 kostet eine Verbindung
zwischen meinem Computer und dem von "imart" 23Pfg/60sec.
Bei diesem kurzen Beispiel würde eine Verbindung im Rest der Woche
(von Montag 18:00:00 bis Samstag, 23:59:59) 23Pfg/120sec kosten.
Seit Version 1.09 kann man auch folgende neue C-Zeilen benutzen:
"C LOCAL" für Verbindungen, die keine Kosten verursachen (z.B. bei
Verbindung über Null-Modem), und "C IGNORE" für Verbindungen, die
überhaupt nicht berücksichtigt werden sollen. LOCAL und IGNORE
müssen jeweils die einzigen C-Zeilen für einen Host sein (keine
anderen Kosteninformationen sind erlaubt), und sie schließen sich
außerdem gegenseitig aus.
Beispiel:
N imart
C LOCAL
Verbindung mit imart ist "LOCAL" und kostet nichts; nur die
in/out-Bytes tauchen in der Statistik auf.
Beispiel:
N imart
C IGNORE
Verbindung mit imart taucht überhaupt nicht in der Statistik auf.
Seit Version 1.14 kann man als Dauer einer Einheit auch "0" angeben,
dann wird für die gesamte Verbindung (den Abschnitt der Verbindung,
der in den durch die "C"-Zeile angegebenen Zeitraum fällt), nur eine
einzelne Einheit verrechnet. Diese Option ist innerhalb Deutschlands
meines Wissens nicht relevant.
Beispiel:
N imart
C SU-00:00:00 0 0.23
C MO-08:00:00 60 0.23
C MO-18:00:00 120 0.23
In diesem Beispiel würde für jede Verbindung zwischen Sonntag, 0:00 Uhr
und Montag, 8:00 Uhr nur eine einzelne Einheit verrechnet.
Beispiel für eine komplette XStat.data Datei:
---------------------------------------------
- schnipp - schnapp - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp
H XSTAT DATA
#==============================================================================
# XStat connection cost data file
#==============================================================================
#
#------------------------------------------------------------------------------
# currency sign for Germany; S must come before first N
#------------------------------------------------------------------------------
S DM
#
#------------------------------------------------------------------------------
# my own newsfeed, connection cost is 0.23/60sec (0.23/120sec night & weekend)
#------------------------------------------------------------------------------
N imart
N .illegal.
C SU-00:00:00 120 0.23
C MO-08:00:00 60 0.23
C MO-18:00:00 120 0.23
C TU-08:00:00 60 0.23
C TU-18:00:00 120 0.23
C WE-08:00:00 60 0.23
C WE-18:00:00 120 0.23
C TH-08:00:00 60 0.23
C TH-18:00:00 120 0.23
C FR-08:00:00 60 0.23
C FR-18:00:00 120 0.23
#
#------------------------------------------------------------------------------
# cbmger, brewak, forge, default:
# connection cost is 0.23/21sec (0.23/42sec night & weekend)
#------------------------------------------------------------------------------
N cbmger
N brewak forge
N .default.
C SU-00:00:00 42 0.23
C MO-08:00:00 21 0.23
C MO-18:00:00 42 0.23
C TU-08:00:00 21 0.23
C TU-18:00:00 42 0.23
C WE-08:00:00 21 0.23
C WE-18:00:00 42 0.23
C TH-08:00:00 21 0.23
C TH-18:00:00 42 0.23
C FR-08:00:00 21 0.23
C FR-18:00:00 42 0.23
#
#------------------------------------------------------------------------------
# modula, this is a local (e.g. null-modem) connection
#------------------------------------------------------------------------------
N modula
C LOCAL
#
#------------------------------------------------------------------------------
# walker, connects will be ignored
#------------------------------------------------------------------------------
N walker
C IGNORE
#
- schnipp - schnapp - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp
Aufruf
======
XStat [?] [DATA name] [FILE name] [V | VERBOSE] [FD | FROMDATE date]
[TD | TODATE date] [NI | NOINCOM] [NO | NOOUTGO]
[H | HOSTNAME name] [M | MONTH shortdate] [SE | STDERR]
[P | PREVIOUS numdays] [L | LAST numdays]
Alternative Syntax:
XStat FILE/K,DATA/K,V=VERBOSE/S,M=MONTH/K,NI=NOINCOM/S,NO=NOOUTGO/S,
Q=QUIET/S,H=HOSTNAME/K,FD=FROMDATE/K,TD=TODATE/K,SE=STDERR/S,
P=PERIOD/N,L=LAST/N
Sie können auch die Environment-Variable "XSTATARGS" benutzen, um
Parameter an das Programm zu übergeben. Das ist besonders nützlich,
wenn Sie XStat von der Workbench aus benutzen (XStat unterstützt
die Workbench eigentlich nicht, daher hat es auch kein Icon).
?
-
Zeigt eine Hilfsmeldung an.
DATA name
---------
Gibt den Namen für die Verbindungskosten-Datei an. Die Voreinstellung
für <name> ist "UULIB:XStat.data".
FILE name
---------
Gibt den Namen für das Logfile an, das ausgewertet werden soll.
Die Voreinstellung für <name> ist "UUSPOOL:XferStat".
V | VERBOSE
-----------
Steuert den "verbose"-Modus. Wenn der "verbose"-Modus eingeschaltet
ist, zeigt XStat zusätzlich eine kurze Statistik für jeden Connect an.
Die Voreinstellung ist "aus". Geben Sie VERBOSE an, um den "verbose"-
Modus einzuschalten.
WARNUNG! Die VERBOSE-Option wird bald drastisch geändert werden,
vermutlich bereits in der nächsten Programmversion.
FD | FROMDATE date
------------------
Führt dazu, daß Connects, die vor dem angegebenen Datum stattgefunden
haben, ignoriert werden. Voreinstellung für <date> ist "01-JAN-78".
Gültig sind alle normalen AmigaDOS Datumsangaben, insbesondere auch
Angaben wie "TODAY" oder "YESTERDAY". XStat fügt intern eine Zeitangabe
von "00:00:00" hinzu, die nicht manuell mit angegeben werden darf!
Falls Sie die neue Workbench 2.1 benutzen, die im Moment nur
eingetragenen Entwicklern zugänglich ist (sein sollte), und falls sie
eine andere Sprache als Englisch eingestellt haben sollten, müssen Sie
die Datumsangaben in dieser Sprache machen; für Deutsch also z.B. "HEUTE"
anstatt "TODAY".
Bitte beachten Sie die Warnungen unter "PREVIOUS" und "LAST"!
TD | TODATE date
----------------
Führt dazu, daß Connects, die nach dem angegebenen Datum stattgefunden
haben, ignoriert werden. Voreinstellung für <date> sind das gerade gültige
Datum und die gerade gültige Uhrzeit. Zulässig sind alle normalen AmigaDOS
Datumsangaben, insbesondere auch Angaben wie "TODAY" oder "YESTERDAY". XStat
fügt intern eine Zeitangabe von "23:59:59" hinzu, die nicht manuell mit
angegeben werden darf! In Sachen 2.1/locale gilt das gleiche wie für FD.
Bitte beachten Sie die Warnungen unter "PREVIOUS" und "LAST"!
M | MONTH shortdate
-------------------
Führt dazu, daß XStat die Parameter FD und TD ignoriert und statt
dessen eine Statistik für den angegebenen Monat erzeugt. Der Monat muß im
Format "MMM-JJ" angegeben werden, also ohne Tageszahl.
Beispiel: "MONTH JUN-92" erzeugt eine Statistik für den Juni 1992.
Bitte beachten Sie die Warnungen unter "PREVIOUS" und "LAST"!
NI | NOINCOM
------------
Unterdrückt die Auswertung der eingehenden Anrufe; Voreinstellung ist
"nicht unterdrücken". Geben Sie NI an, um die Verarbeitung eingehender
Anrufe zu verhindern. Die Bedeutung dieses Schalters war vor 1.04 umgekehrt.
NO | NOOUTGO
------------
Unterdrückt die Auswertung der ausgehenden Anrufe; Voreinstellung ist
"nicht unterdrücken". Geben Sie NO an, um die Verarbeitung ausgehender
Anrufe zu verhindern. Die Bedeutung dieses Schalters war vor 1.04 umgekehrt.
Q | QUIET
---------
Steuert den "quiet"-Modus. Unterdrückt die Ausgabe von weniger schweren
Fehlermeldungen; Voreinstellung ist "nicht unterdrücken". Geben Sie
QUIET an, um die Ausgabe weniger schwerer Fehlermeldungen zu verhindern.
Der "quiet"-Modus ist besonders nützlich, um die "(ignoring this one)"-
Meldungen für fehlgeschlagene Verbindungsversuche zu unterdrücken.
H | HOSTNAME name
-----------------
Veranlaßt XStat, nur Anrufe für den Host <name> auszuwerten;
Voreinstellung ist Auswertung aller Anrufe. Ab V1.06 darf für <name> auch
ein beliebiges AmigaDos-Suchmuster angegeben werden. Falls ein solches
Muster angegeben wird, erstellt XStat außerdem für jeden Host, auf den
das Muster paßt, eine eigene Statistik.
Bei den Suchmustern wird nicht zwischen Groß- und Kleinschreibung
unterschieden.
Beispiel: XStat hostname (a|x)#?
wertet nur Anrufe aus, bei denen der Host-Name mit "a" oder
"x" beginnt. Erstellt eigene Statistiken für alle diese
Hosts.
Neues Feature in 1.15:
Wenn der Name KEIN Pattern enthält (also Klartext ist), dann erzeugt
XStat nur Statistiken für diesen Host, aber KEINE "TOTAL"-Statistiken.
SE | STDERR
-----------
Veranlaßt XStat, alle Fehlermeldungen nach StdErr zu schicken, statt
nach StdOut. Dann kann man nämlich die Statistiken mittels ">File"
in eine Datei umleiten, ohne daß die Fehlermeldungen auch dorthin
wandern; Voreinstellung ist "alles nach StdOut". Geben Sie STDERR an,
um die Fehlermeldungen nach StdErr zu schicken. StdErr ist stets das
Console-Fenster, von dem aus XStat gestartet wurde.
Hinweis: Diese Option wurde nur mit der Commodore-eigenen AmigaShell
getestet. Es müßte aber auch mit anderen Shells funktionieren.
P | PERIOD numdays
------------------
Zeigt die Statistik für einen bestimmten Zeitraum an. Der Zeitraum
ist von "FROMDATE" bis "FROMDATE+numdays".
WARNUNGEN:
(1) sowohl "MONTH" als auch "TODATE" werden ignoriert
(2) "numdays" wird nicht überprüft, wenn Sie extrem hohe Werte
angeben, können Sie einen internen Überlauf provozieren
(3) Sie dürfen nicht gleichzeitig "PERIOD" und "LAST" angeben
(4) "numdays"=1 zeigt die Statistic für "FROMDATE" und den
darauffolgenden Tag an
L | LAST numdays
----------------
Zeigt die Statistik für einen bestimmten Zeitraum an. Der Zeitraum
ist von "TODATE-numdays" bis "TODATE".
WARNUNGEN:
(1) sowohl "MONTH" als auch "FROMDATE" werden ignoriert
(2) "numdays" wird nicht überprüft, wenn Sie extrem hohe Werte
angeben, können Sie einen internen Unterlauf provozieren
(3) Sie dürfen nicht gleichzeitig "PERIOD" und "LAST" angeben
(4) "numdays"=1 zeigt die Statistic für "TODATE" und den
Tag davor an
XStat's Ausgaben
================
Beispiel:
> (On 25-DEC-93) XStat last 30
>
> XStat 1.15
> © Copyright 1992-94 by Jürgen Weinelt
> XStat is Freeware - read the docs for details.
>
>
>
> TOTAL: Connection statistics for incoming calls.
>
[...]
>
>
>
> TOTAL: Connection statistics for outgoing calls.
>
> Transfer statistics from 25-Nov-93 18:24:07 to 25-Dez-93 18:24:07
>
> number of connects 54
> local connects 0
> ignored connects 0
>
> total online time 8112 seconds
> total phone units 98 units
> total phone cost 22.540 DM
> average online time 151 seconds/connect
> average phone units 1.815 units/connect
> average phone cost 0.417 DM/connect
>
> total gross read 10491743 bytes
> total gross send 1819008 bytes
> total net read 8347777 bytes
> total net send 106961 bytes
> average gross read 194292 bytes/connect
> average gross send 33686 bytes/connect
> average net read 154589 bytes/connect
> average net send 1981 bytes/connect
>
> average speed 1517 CPS (gross data transfer)
> fastest connect 1653 CPS (gross data transfer)
> average speed 1042 CPS (net data transfer)
> fastest connect 1366 CPS (net data transfer)
>
> average cost 1.920 DM/MB (gross data transfer)
> average cost 2.795 DM/MB (net data transfer)
Hinweise:
"gross" steht für Brutto-Übertragung, also incl. Protokolldaten.
"net" steht für Netto-Übertragung, Protokolldaten also nicht
mitgerechnet.
History
=======
V1.15 Fehler in FORMS.dok behoben. Fehler in der Format-Ausgabe behoben.
&HN-Format/HOSTNAME verbessert. "WARN"-Returncode wenn gar keine
Connects.
V1.14 Ausgabeformate, Verbindungsdauer-Offset und pauschale Verbindungskosten
eingeführt
V1.13 "PERIOD" und "LAST" eingeführt
Datumszeile zu den Ausgaben hinzugefügt
V1.12 Reservierter Hostname ".illegal." eingeführt
Potentieller Fehler im XferStat Parsing behoben
V1.11 XStat.data N-Zeilen-Syntax erweitert: es dürfen mehrere N-Zeilen
aufeinander folgen, und es darf ein ".default."-Hostname verwendet
werden.
Kleiner Fehler in der EOF-Behandlung des Xferstat-Parsers behoben.
V1.10 XStat.data N-Zeilen-Syntax erweitert: mehrere Namen pro Zeile erlaubt.
Kleiner Fehler im NI/NO-Feature behoben.
V1.09 XStat.data-Syntax um LOCAL und IGNORE erweitert.
V1.08 Option "STDERR" hinzugefügt. "ø" durch "av." ersetzt.
V1.07 Die Liste der Statistics-Records wurde nicht korrekt sortiert.
Behoben.
V1.06 Die "HOSTNAME" Option versteht jetzt auch Suchmuster. Die "pro Host"
Statistiken wurden in die "HOSTNAME" Option integriert.
V1.05 Statistiken "pro Host" hinzugefügt.
V1.04 Einen Fehler behoben (Problem mit 2.1 locale) und Argumenten-
Parsing auf dos.library "ReadArgs()" umgestellt
V1.03 Monatliche Statistiken hinzugefügt.
V1.02 Angabe der Spitzengeschwindigkeit (Geschw. des schnellsten
connects) hinzugefügt.
V1.01 XStat produzierte einen Guru, wenn brutto oder netto nur 0 Bytes
übertragen wurden. Behoben.
V1.00 Erst-Veröffentlichung :-)
V0.9x diverse Betas
Bekannte Probleme/Bugs
======================
Die MONTH Option kann unter gewissen Umständen fehlerhafte Ergebnisse
liefern. Dies ist KEIN Bug von XStat. Die Funktion der dos.library zur
Datumskonvertierung ist unzuverlässig. C= wird diesen Fehler in der
Release-Version der "nach 3.0"-Kickstart beheben.
Die "online time" ist nicht besonders genau. Das kommt daher, daß die
Anfangszeit der Verbindung anscheinend ab dem Zeitpunkt gerechnet
wird, zu dem das Modem "CONNECT" sagt, und das ist nicht der wirkliche
Start-Zeitpunkt der (Telefon-)Verbindung. Dies kann durch Verwendung
des in 1.14 neu hinzugekommenen Verbindungsdauer-Offset wesentlich
verbessert werden.
Wenn Sie Fragen haben, oder Fehler entdeckt haben...
====================================================
Sie können mich per eMail erreichen:
jow@rz.uni-wuerzburg.de (vorzugsweise)
jow@hcast.franken.de
jow@hcast.adsp.sub.org (möglichst vermeiden, bitte)
Oder mit der Bundespest (Rückporto bitte nicht vergessen!):
Jürgen Weinelt
Franz-Ludwig-Straße 10
D-97072 Würzburg
Sie können auch nach alt.sys.amiga.uucp posten oder
de.comp.sys.amiga.uucp posten.
Viel Spass!
Danksagung
==========
Die folgenden Leute haben mir mit diversen Anregungen und Bug-Reports
sehr geholfen:
Christian Balzer
Kai Bolay
Christof Damian
Hartmut "Essich" Goebel
Tommy V. Hansen
Tapio Heiskanen
Michael-Wolfgang Hohmann
Alfredo Jahn V
Andrew "Charly" Kopp
Erik Kunze
Matthias "Tron" Scheler
Henning "Barnard" Schmiedehausen
Kai "wusel" Siering
Peter "Peti" Simons
Vielen Dank Euch allen.